;============================================================================ ; Diese Funktion benutzt einen vorgegebenen Format-String um die angegebenen ; Argumente zu formatieren und als einen neuen formatierten String auszugeben. ;---------------------------------------------------------------------------- ; Synopsis: string = VSPrintF (FormString, Args) ; D0* A0! A1! ; ; Eingaben: A0 --> STRPTR auf den Ausgabe-Format-String(+0) (s.Bemerkung) ; A1 --> APTR auf das 1. Element des Argumenten-Arrays, die Args ; entsprechen in Reihenfolge und Größe dem Auftauchen ; ihrer Platzhaltersymbole im Format-String ; ; Ergebnis: D0 --> STRPTR - Zeiger auf den generierten Ausgabe-String(+0) ; - 0-PTR, wenn kein Speicher für den String-Puffer ; mehr frei war. ; ; Bemerkung: Der von dieser Funktion generierte String bleibt solange gültig, ; wie Ihr Programm die »extra.library« geöffnet hält, es sei denn, ; Sie geben den String via DiscardString() vorzeitig frei. ; Weitere Informationen zum String-Handling der »extra.library« ; finden Sie im Abschnitt String-Verwaltung. ; ; C/C++ Programmierer können auch die Funktion »VSPrintFArgs()« ; zur Angabe einer beliebigen Anzahl von Argumenten auf dem Stack ; verwenden, welche als Stub in der »rhosigma.lib« enthalten ist. ; ; Siehe auch: DiscardString() ;============================================================================